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Preface 



These release notes accompany the Xii/News™ server provided with release 1.0 
of Open Windows . The notes discuss changes that have been made to News 
since the release of News 1.1; they also discuss differences from release 3 ofxii, 
from MIT. This document should be read by customers who have been using 
either News 1.1 or public domain versions of thexii server available from MIT. 

After reading these release notes, reread the Read This First document provided 
with this release of OpenWindows. 

The XView toolkit, the News toolkit, and the Xii/News window manager are 
based on an early version of the OPEN LOOK Graphical User Interface 
Specification, and they therefore do not necessarily implement every element in 
the most recent revision of that specificatioa^ OPEN LOOK references thus point 
to software that has not yet been validated by AT&T as fuUy OPEN LOOK com- 
pliant, although ftiU validation is expected shortly. 



^ OPEN look" is a trademaik of AT&T. 
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Introduction 



This document describes the notable changes and enhancements in release 1.0 
(Revision A) of Xii/News, compared with both News 1.1 and the XI 1 Release 3 
window system available from MIT. 

News is now supported as part of the Xii/News server, which itself forms a part of 
the OpenWindows distributed window system. The Xii/News server runs win- 
dowing applications written with either Ae Xii or the News protocol. Though the 
two protocols are entirely different, Xii/News provides an integrated environment 
in which both are supported. Thus, whenxii and News applications simultane- 
ously display windows, the windows coexist on the screen and can be made to 
overlap in any way. Cut and paste selections can be made between xii and News 
windows. All the windows are manipulated by a single window manager. 

The Xii/News server, which forms the window system platform of the OpenWin- 
dows environment, can be used to run applications of the following kinds: 

□ All correctly-written xi i applications, such as those built with the XView 
user interface 

□ News applications that conform to News 1.1 documented interfaces (includ- 
ing Lite toolkit-hsised applications) 

□ SunView- and SunWindows-based applications 

The server also supports the running of networked applications: thus, you can 
run client programs on remote machines, using your local machine to display the 
corresponding windows. 

A set of XView applications is provided with this release of OpenWindows; the 
set includes a shell command tool, a file manager, a text editor, a mail tool, and 
other tools. 
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Changes to NeWS 



Numerous features have been added to the News language, including extensible 
News objects, packed arrays, classes for input handling, and better support of the 
PostScript language as defined in the PostScript Language Reference Manual 

In addition, the following changes have occurred: 

□ The News toolkit (formally known as the Ni^s Development Environment or 
NDE) has become the preferred NeWS-based toolkit. TTie old Lite toolkit has 
been retained in its original form but will no longer be enhanced. 

□ Windows provided by XView and the News toolkit correspond to the OPEN 
LOOK User Interface Specification. OPEN LOOK is an easy-to-use graphical 
interface. 

o Minor differences between the Xi i and News window systems have necessi- 

tated changes to the News language. 

□ Adjustments have been made to facilitate future development of the product 
and ensure continued quality. 

2.1. Changes in File The default installation-directory for OpenWindows is now, for all machines 

Location except the 386i, /home/openwin. For a 386i, the default installation- 

directoryis /f iles/local/sun386/openwin. You must then set the 
environment variable OPENWINHOME to the directory in which the product 
has been installed. The NEWSHOME environment variable is now ignored. See 
the OpenWindows Installation and Start-Up Guide for full information. 

The following changes have also occurred: 

□ Startup files — The user . ps and startup . ps files, which are read ftom 
your home directory when Xii/News is started, have now been renamed 
.user.psand.startup.ps. 

□ Images are stored in $OPENWlNHOME/demo/images instead of 
$ NEWS HOME /smi. 

□ The client source is in $OPENWINHOME/share/src/xnews instead of 
$NEWSHOME/clientsrc. 

□ The server is now $OPENWINHOME/bin/xnews, not 
$NEWSHOME/bin/news server. 
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2.2. Changes in File Access 



2.3. New Environment 
Variables 



2.4. Revised * .ps Files 



Root Menus 



LiteWindow Changes 



□ PostScript language files read in by the server at start-up are stored in 
$OPENWINHOME/etc/NeWS instead of $NEWSHOME/lib/NeWS. 

□ Font files read in by the server are stored in 
$OPENWINHOME/ lib/ fonts. 

With the change in the location of the start-up POSTSCRIPT language files, the file 
and run POSTSCRIPT language operators (together with all the News utilities that 
use them) now search the following directories in turn: 

1. The directory . / (the directory in which the server has been started) 

2. The directory " / (the user’s home directory) 

3. The directory $ OPENWINHOME /etc/ 

The Xii/News server offers a number of new environment variables. Among 
these is NEWSONLY. When no XI 1 clients will be run, NEWSONLY can be 
set to reduce memory consumptioa See the manual page for xnews in the 
xiliN^S Server Guide for a description of all the environment variables. 

Much of the behavior and fimctionality of the Xii/News server is determined by 
files containing POSTSCRIPT language code read in at startup. These files are dif- 
ferent from the * . ps files in News 1.0 and 1.1; thus, News users may find some 
incompatibilities (these are described in this document). The changes have been 
made to allow the server to be started up in various modes (for example, as a 
filter, or as an output-only device)^ 

The following sections discuss the incompatibilities in greater detail Refer to 
the Programmer’s Guide for a fuller description of the new * . ps files. 

The rootmenu is now implemented using the News toolkit instead of Lite. The 
programming interface is different The preferred method of customizing the 
root menu involves modifying files in the SunView rootmenu format and running 
buildmenu. See the XlliNOVS Server Guide for instructions. 

In the past, some client programs used get to retrieve the FrameMenu of their 
window in order to change it: 

> 

win /FrameMenu get 

V / 



Using get this way is improper, and it was a coincidence of implementation that 
it ever worked at all. In Xii/News, this construct no longer works. Instead, you 
should use send to get the menu: 



— 

/FrameMenu win send 




1 


J 



Note that inxii/NeWS, the frame menu is shared by all instances of LiteWindow. 
If you modify the frame menu in a particular application, all other applications 
ultimately use the modified menu. Thus, instead of modifying the frame menu. 
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Making a Debugging Server 



Verbose Loading 



2.5. Changes in News Class 
Implementation 



2.6. Look and Feel 
Changes 



you should define a ClientMenu for your window. You can include the 
FrameMenu as a submenu of the ClientMenu if you wish. You should define 
the ClientMenu during window initialization: 

— > 
/win framebuffer /new DefauitWindow send def 
{ 

/CreateFrameMenu win send 
/ClientMenu [ 

(Rrst Function) { first } 

(Second Function) {second} 

(Frame =>) /FrameMenu win send 
] /new DefaultMenu send def 
} win send 

s, t 



The procedures *goF and ‘DebuggingServer?’ have been removed. To make 
the server start up an executive session on the terminal from which you start it, 
you should change, within your . user . ps file, the statement 

\ 

/DebuggingServer? true def 

s > 



to the following: 

/&main /&main load (executive) append cvx def 
^ > 



This redefines the “main routine” of the server to start an executive session. 

The old ‘verbose?’ flag, which made the server print out the files as it loaded 
them, has been removed from init . ps. To achieve the same effect, simply 
replace LoadFile in your . startup . ps file so that it provides some feedback 
(note that if you redefine LoadFile in your . user . ps file, the change takes 
place after most files have been loaded.) 

Many new operators and methods are now available for use with classes. These 
operators and methods are described in detail in Chapter 4, Classes, of the 
Programmer’s Guide. The class system now supports multiple inheritance. See 
the NS^S Programmer’s Guide for details. 

Also, there is a new class-based event manager named ClassEventMgr. This is 
simply a class-based use of the existing forkeventmgr- eventmgrinterest pair. 

The default typing style in OPEN LOOK is click-to-type, meaning that you must 
click the left mouse button in a window before it can receive your keystrokes. If 
you are familiar with \3a&focus-follcfws-cursor style, which was previously used 
by News, the new style may take some getting used to. 

It is possible to set the typing style back to focus-follows-cursor by adding the 
following line to your “ / . Xde fault s file: 
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You can also use the Properties program on the rootmenu to change back to 
focus-follows-cursor style. 

2.7. New and Modified This section discusses News operators that have been either added or modified 

News Operators since News 1.1. See the Programmer’s Guide for information on these 

operators. 

New Operators The following operators are new: 

Table 2-1 New Operators 



canvasesunderpath 


getcard32 


putcard32 


canvasesunderpoint 


getcolor 


refcnt 


countfiieinputtoken 


getfileinputtoken 


reffinder 


createcolormap 


getprocesses 


setbackcolor 


createcolorsegment 


getprocessgroup 


setbackpixel 


currentbackcolor 


grabcursor 


setcursorlocation 


currentbackpixel 


harden 


setpacking 


currentpacking 


lasteventkeystate 


setpixel 


currentpixel 


lasteventtime 


setplanemask 


currentplanemask 


lasteventx 


setshared 


currentshared 


lasteventy 


soft 


currentstate 


newcursor 


soften 


encodefont 


objectdump 


truetype 


eoextenddamageall 


packedarray 


writeobject 


extenddamageall 


postcrossings 





The following operators have been renamed: 

□ C 

This operator is now named shutdownserver. 

□ forkunix 

This operator is now named runprogram. 

The following operators now have two possible syntactic forms: 



Renamed Operators 



Polymorphic Operators 
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createcolorsegment 

encodefont 

expressinterest 

getfileinputtoken 

movecanvas 

newcanvas 

newcursor 

reshapecanvas 

revokeinterest 

setfileinpttttt^eii 



Raster-Op Code not Reset In News 1 . 1, a bug existed whereby certain operations, if performed after the 

After setrasteropcode raster-op code was set, caused the raster-op code to be reset to another value. In 

Xii/NeWS 1.0, you must explicitly reset the raster-op code. Applications that rely 
on the raster-op code being non-expliciUy reset may now paint their canvases 
strangely. 



2.8. Improved Support of 
the PostScript 
Language 

Image Operators Implemented 



OpenWindows includes additional support for the PostScript language as 
defined by Adobe Systems in the PostScript Language R^erence Manual. 

The settransfer and currenttransfer functions are implemented. 



2.9. New Types The following types are new: 

/colormaptype 

/colormapentrytype 

/cursortype 

/environmenttype 

/packedarraytype 

/visualtype 



See the News Programmers Guide for information on these types. 



2.10. Changes to Existing OpenWindows contains all the types that exist in News 1.1. However, some of 
Types the types now contain additional keys and have new fimctionality. The changes 

are listed in the sections below; see the N^s Programmer’s Guide for more 
detailed information. 



2.11. Paths 



The type formerly named shapetype is now named pathtype. 
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2.12. Canvases 



Change in the Behavior of 
Transparent Canvases 



Overlays 



2.13. Events 



Input Handling Changes 



The following keys are new: 

Cursor 

Colormap 

Grabbed 

GrabToken 

Visual 

VisualList 

OverrideRedirect 

BorderWidth 

UserProps 

XID 

SharedFUe 

RowBytes 



In News 1.1, making a transparent child canvas retained would change its parent 
to be retained; however, the converse, making a transparent retained child non- 
retained had no effect. 

In xii/News, making a transparent child retained or non-retained does not affect 
the transparent canvas or its parent. 

News 1.1 handled only one overlay at a time. If more than one existed, you 
would generally only get correct behavior from the most recently created over- 
lay. Xii/News can handle multiple simultaneous active overlays. 

The following keys are new: 

IsPreChild 

Coordinates 



As part of the merge with xii, there have been a number of changes in News’ 
input handling. One major change is that global interests have been replaced 
with pre-child interests. 

Attendant incompatibilities include: 

□ If the Canvas field of an interest contains nuU, the interest is placed on the 
root canvas’ pre-child interest list, but the Canvas field remains null. 

□ In event delivery, an event with an explicit destination canvas is tested for a 
match against pre-child interests on each of its ancestors (in root-to-leaf 
order) before tjeing tested against the destination canvas. 

□ In event delivery, the Canvas field of the delivered event is no longer 
modified to indicate the canvas of the interest that matched the event; that 
information is available from the Interest field of the delivered event, as it 
has always been. 



sun 

microsystems 



Revision A, of 2S August 1989 





Chapter 2 — Changes to NdWS 13 



Internal Implementation of eventmgrinterest returns an interest that you pass to forkeventmgr. The inter- 

eventmgrinterest and face to these operators is unchanged from News 1 . 1 in xi I/News, however, their 

forkeventgmr implementation is different. Programs should not assume any particulars about 

the internal format of the interests used by eventmgrinterest/forkeventmgr. 

Changed Action on Canvas The value of the Action field in the EnterEvent or ExitEvent (generated when 
Entry/Exit the cursor crosses a canvas) is different in Xi i/NeWS than in NeWS 1.1. 

Change in Focus Event In News 1.1, when a canvas lost the keyboard focus, a /Deselect event with 

Naming action /InputFocus was generated. This was ambiguous, however, because 

/Deselect also signals the loss of ownership of the selection named in the Action 
field, and /InputFocus could be the name of a particular selection. 

So, in XI 1/News, when a canvas loses the focus, an event named /LoseFocus is 
generated instead of a special kind of /DeSelect. 

Focus events are now generated like Enter and Exit events: thus, ancestors of 
the canvas that has the focus receive events, but with different Action values. 

Time Value Changes Time stamps in the xi i/NeWS server have been changed, for convenience in 

merging with xii. This change affects the value of timestamps in News events 
(the TimeStamp field in the event), and the values returned by the currenttime 
and lasteventtime primitives. In News 1.1, ‘ 1 .0’ in a time value was one minute. 
It now is 2^^ milliseconds, or 65.536 seconds. This means that the News clock in 
Xii/News “ticks” about 9% slower than before. To convert the new time values 
to minutes, multiply by 1.092267. One second is now about 0.01526, where it 
used to be 0.016667. 

Shared Interests Interests can now be shared between canvases. The Canvas field of an event can 

thus contain either a single canvas, or a dictionary or array that contains multiple 
canvases. See the NdVS Programmer’s Guide for information. 

Executable Matches Executable matches are now permitted by executable Canvas, Name, and Action 

dictionary values in interests. These provide a highly efficient way of executing 
code according to the canvas on which an interest has been matched. Using this 
procedure, PostScript language constructs such as case, which are nomially 
used to vector a matched event to the correct handler, are made unnecessary. 

Special Events News now generates the following special events: 

□ /Damaged: Damage events are generated for a canvas whenever it is graphi- 
cally damaged (a definition of damage is provided in the chapter Canvases 
of the News Programmer’s Guide). The server will not send another damage 
event until the damage has been cleared by use of the damagepath operator. 
The Action key value for the event is null; the Canvas key value specifies 
the affected canvas. 

o /Obsolete: The server generates obsolescence events to inform clients that 
an object is obsolete and that processes should destroy their references to it 
The Action key of the event is a soft reference to the obsolete object 
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□ /ProcessDied: the server generates a ProcessDied event if a process dies 
(quits) when it is still referenced. The Action key of the event specifies the 
process that died. When a process is dead but is still referenced, its State 
key is set to zombie. 

2.14. Processes The following keys are new: 

$error 

errordict 

Priority 

Stdout 

Stderr 

SendContexts 

SendStack 



Changes to Process Objects Xii/News adds a new key to process objects, Priority. All processes now have a 

priority that they inherit from their parent Currently this priority is not used to 
order dieir execution or favor certain lightweight processes (as it is in the UNIX 
kernel). 

However, there is a minimum priority that a process must exceed if it is to run. 

If a process’s priority is lower than this system-wide minimum, then it is queued 
until the system- wide priority drops. Currently News processes can set their 
priority but carmot influence the system-wide priority. 

The motivation for this change is to support the various flavors of xii Grab- 
Server requests. During a grab, process and system-wide priorities are adjusted 
so that only important system processes (including the repeat key handler, the 
global input distribution process, and the connection managers) and the Xii con- 
nection requesting the grab execute. The change should not affect News pro- 
grammers, and Sun advises against developers using the mechanism for toeir 
own purposes: it is not a general purpose mechanism and is subject to change. 

2.15. Changes in Error This section describes the differences in error handling between News 1.1 and 

Handling xi I/News. Note that error handling has changed since preliminary versions of 

XI i/News. Error handling is now more compatible with the PostScript Language 
Reference Manual. 

Upon detecting an error. News 1.1 would search for an error handler by looking 
for dictionaries called errordict on the dictionary stack. If it found an errordict 
containing the error name as a key, it would execute the associated value. The 
PostScript Language Reference Manual indicates that errordict is a special dic- 
tionary fliat can be found in systemdict. The error behavior described in the 
PostScript Language R^erence Manual mentions no such dictionary stack 
search. In Xll/NeWS, each process can have a private errordict. This errordict is 
found in systemdict and as a magic key of processes. (See the description of the 
errordict key in the NS^S Programmer’s Guide for a description of how this dic- 
tionary is shared.) In Xii/News, this is the only dictionary that is searched for the 
name of the error, when initialized, it contains an entry for each error that the 
server can generate. 
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News 1.1 would override the action listed in errordict if the error was stacko- 
verflowor execstackoverf low. In XI i/NeWS, the listed error handler is 
only overridden if the operand stack has less than 10 slots left before it 
overflows, or if the execution stack has less than 3 slots left before it overflows. 
Since operations such as 2000 array aload can cause operand stack overflows 
while the operand stack is still fairly small, the new behavior is therefore some- 
what less restrictive. 

If no error handler was found in the dictionary search, the News 1 . 1 default error 
action would compose the $error dictionary as mentioned in the PostScript 
Language R^erence Manual, and place that dictionary in the userdict. If the 
process had no userdict, no $error dictionary would be generated. The condi- 
tional behavior of the News 1. 1 default error action caused problems in finding 
the $error dictionary after an error. In Xii/News, the $error dictionary, which is 
private to each process, can be found in systemdict and as a magic key of the 
process. (See the description of the $error key in the NS^S Programmers Guide 
for a description of how this dictionary is shared.) Until a process has an error, 
the value is null; thereafter it is a dictionary containing the information men- 
tioned in the PostScript Language Reference Manual. 

2.16. Changes to Magic “Magic dictionaries” are used by some of the News types, including canvases. 

Dictionaries events, colors, and processes. These had a fixed set of keys in News 1.1. 

Xii/NeWS allows you to add your own keys beyond the fixed set. The fixed set of 
keys are still there when the object is created and still cannot be removed. 

Note that if you misspell one of the existing keys, you will get no complaint, but 
will have created a new key /or that one instance of the object only. In News 1 . 1 
the documentation warned programmers not to put arbitrary keys in magic dic- 
tionaries. However, if you did so, the implementation meant that the key would 
be added to all instances of the dictionary, becoming, in effect, global. For 
example, we found many programs that misspelled /TimeStamp as /Timestamp 
when setting the time in events. Other programs would def some key while the 
uppermost dictionary on the stack was an event. It is possible that your programs 
rely on the News 1.1 behavior in such cases. 

2.17. News Fonts The source format forNeWS fonts has not changed. However, the format of the 

News native bitmaps fonts (in the $OPENWINHOME/lib/fonts directory, 
usually with the extension . f b) has changed in xii/NeWS and is thus incompati- 
ble with the News 1.1 format. The new format is used by both News and Xli 
code; thus, the two protocols can share the same bitmap fonts. Note that the 
xii/NeWS bitmap format is different from the xii format used by versions of the 
XI 1 server released by MIT for Suns. 

The format of the News font family files (in the $OPENWlNHOME/lib/fonts 
directory, usually with the extension . f f) also changes withxii/News. 

These two changes may not affect you, since the Xii/News server comes with a 
full set of fonts in the new format, but if you have developed your own fonts, you 
must proceed as follows: 
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1 . Change directory to your own font directory. 

2. Run convert f ont to convert your font to the new NeWS format. 

3. Run bldf amily to rebuild the font family files in their new formats. 

Adobe Bitmap Font Format The News ASCII bitmap font format generated by convert f ont (1) was 

changed to be compatible with the very latest (version 2.1) Adobe bitmap font 
format specification. This is also whatxii uses, with a slightly different interpre- 
tation. News used version 1.4. However, the convertf ont program under- 
stands the old and new versions of the Adobe bitmap font format, as well as the 
XI 1 interpretation of version 2.1. The differences among these versions are very 
small, convertf ont also understands old (News 1.1) format font files. To 
convert a font, run convertf ont on it. The new and old formats have new 
magic numbers, so there is no chance of News or convertf ont getting con- 
fused. 

For more information on font support inXii/NeWS, see the XlliNe^s Server 
Guide. 

Scalable Fonts A new font format, OpenFont, is supported. This new format allows a single 

font file to be scaled to any point size and rotated to any angle. The suffix for 
these fonts is . f 3b. Typing Is * . f 3b in the directory 
$OPENWINHOME/ lib/ font s shows which fonts are in this format. A list of 
these fonts is provided in theXii/N^S Server Guide. 

2.18. Changes to CPS If your program includes a header file generated by cps, you no longer need the 

following in your C client source: 

finclude psio.h 

It is included for you when cps creates the . h file. 

Changed CPS routines ps_f lush_PostScript ( ) used to call psio_error ( ) itself and would 

exit ( 0 ) if there was an error. It now does not do this — it is the responsibility 
of the client to check for errors. 

ps_close_PostScript ( ) now closes PostScriptInput as well as 
PostScript. 

New CPS routines There are many new functions for examining the tokens in the client-side input 

queue. 

ps_check_PostScript_event ( ) 
ps_query_PostScript_event (tag) 
ps_read_PostScript_event (ptag) 
ps_j5eek_PostScript_event (ptag) 
ps_skip_PostScript_event () 

The above routines are supported by new psio routines: 
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ps_checkfor (PostScriptInput, PSIO_CHECK_INPUT, 0) 
ps_checkfor (PostScriptInput, PSIO_FIND_TAG, tag) 
ps_currenttag (Post Script Input, PSIO_GET_TAG, ptag) 
ps_currenttag (Post Script Input, PSIO_PEEK_TAG, ptag) 
ps_skip (PostScript Input) 

The internal routine next_user_token was changed to 
ps_next_user__token ( ) to avoid name clashes. 

2.19. Memory News provides a facility of reference counting that allows objects to survive as 

Management long as references to them exist; references are created by the system whenever 

one object becomes associated with another. 

In News 1.1 there was one kind of reference to an object. There are now two 
kinds of reference: one controls how long an object is in use, and the other is 
used to track an object in the system. When all of the first kind of reference is 
destroyed, the object is said to be obsolete. Processes with references to obsolete 
objects should destroy those references to allow garbage collection to occur. 

When no references of any kind exist to an object, its storage is automatically 
reclaimed. See the News Programmer's Guide for details. 
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Changes to XI 1 



The Xii/News server is a different piece of software from the MIT xii distribu- 
tion. No changes have been made to the xii protocol. Xii/News is compatible 

with XI 1 Revision 3. However, there are some differences between Xii/NeWS and 

XI 1 Revision 3 that should be noted: 

□ XI I/News typically supports multiple color visuals and chooses to make a 
static color visual the default. This promotes sharing of limited color slots. 
This is different from MIT’s Xii. 

□ Color applications should not assume that the default visual is dynamic (like 
the MIT distribution). They need to look at the visuals returned from the 
Xii/News server and locate the dynamic one. Better still, they should use the 
static one so that colors are shared. 

□ The XI 1 -related files in the distribution are limited to the server, Xlib, some 
demos, and some utilities. The Xii Revision 3 version of xterm is provided 
in $OPENWINHOME/demo: it retains the status of pass through or demo 
software. Other libraries and applications should be gleaned from the MIT 
XI 1 distribution tape. 

□ The retained values of closedown mode are unimplemented. 

□ Although the XI i/NeWS font utilities accept the same font source format as is 
found on the MIT distribution, the binary format is incompatible. The 
Xii/News server supplies the same fonts as MIT, plus many more. If you 
have your own fonts, you must run convertf ont and bldf amily on 
them. See the XlliN^S Server Guide for infonnation on fonts and font nam- 
ing conventions. 

□ The default window manager pswm is ICCCM compliant, as aU release 4 
window managers will be. The ICCCM specifies the split between applica- 
tions and the window manager. See the XlliNews Server Guide for a discus- 
sion of the window manager. See the manual page for xnews in the 
X11/N0VS Server Guide for a description of how to use the environment vari- 
able XI lONLY to prevent the window manager from starting. 
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